home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 19 / Mac Magazin and MacEasy Magazine CD - Issue 19.iso / Grafik & Text & Film / Quark XTensions / Freeware Xtensions / Scripts folder / OSA Menu 1.0 / OSA Menu 1.0.1 Docs < prev   
Text File  |  1994-05-09  |  11KB  |  232 lines
  1. OSA Menu 1.0.1
  2. Written by Leonard Rosenthol
  3. Copyright ©1992-1994, Leonard Rosenthol.
  4.  
  5.  
  6. Installation:
  7. If you are reading this, you've probably already done half the
  8. installation! 
  9.  
  10. The only other thing to do is to drag the OSA Menu icon over your System
  11. folder. Doing so will cause the Finder to inform you that “Extensions go
  12. in the Extensions folder” - this is a good thing, and you should click the
  13. “OK” button. Now restart your Mac, and you'll be all ready to use OSA
  14. Menu.
  15.  
  16.  
  17. Description:
  18. The OSA Menu is an iconic system menu (like the Help menu) that appears on
  19. the right side of the menu bar. Its menu items are scripts: choose an item
  20. from the menu and the script will run. Some commands are always available,
  21. and some are only available within particular applications. 
  22.  
  23. Generally the target of the script is the active application, and scripts
  24. that operate on the user selection are particularly useful. Scripts in the
  25. OSA Menu act like extensions to the command set of the application. 
  26.  
  27. The main advantage to scripts in the menu is that you can call them up with one mouse click without leaving the current application. This is most useful in applications that are scriptable (such as the Finder and Aladdin Systems' StuffIt Deluxe & Lite), but require you to switch to another application. BUT NO MORE!! Now you can just choose the script you want to run from the OSA Menu.
  28.  
  29. The scripts live in a folder called "Scripts" in your System folder, and
  30. each application gets its own subfolder of the "Scripts" folder with the
  31. scripts specific to that application as well as a "Universal Scripts"
  32. folder for scripts that you wish to access in all applications.
  33.  
  34.  
  35. What's in the Menu:
  36. The menu has three parts:
  37. *    On top are the fixed commands. Right now there’s only one: the “About OSA
  38. Menu” command that displays an About box.
  39. * Below those are the universal scripts, which always appear.
  40. *    At the bottom are the scripts for the active application.
  41. At the end of each set of scripts is an underlined command that, when
  42. chosen, tells the Finder to open the folder for those scripts. For
  43. instance, when SITcomm is active there is an “Open SITcomm Scripts Folder”
  44. command that opens the “SITcomm Scripts” folder.
  45. These folders are like the Apple Menu Items folder: any script files placed
  46. in them immediately appear in the scripting menu. (They must be compiled
  47. scripts (including Applets and Droplets), not text files.)
  48.  
  49.  
  50. Command Keys:
  51. It is possible to assign a command key to a script by using a special
  52. naming convention. If the name of a script ends with a '\' followed by
  53. another character, then that character will be used as the command key for
  54. the script. For example, the script named "Time Check\T" will have a
  55. command key of "T" in the menu.
  56.  
  57. Use of option or control characters in a menu name is not officially
  58. supported, due to a limitation of the Macintosh Menu Manager. They MAY
  59. work, but if they don't, I am sorry and I have no plans to fix it!!
  60.  
  61.  
  62. Special Features:
  63. * Any of the subfolders of the Scripts folder, or any particular script,
  64. can be an alias. This is very useful for network installations so that all
  65. users can have the same scripts in their menus.
  66. * If you hold down the Option key when selecting a script from the menu,
  67. instead of running the script, the Script Editor will be launched (if not
  68. already running) and the script will be opened for editing.
  69. * If you hold down the Shift key when selecting a script from the menu,
  70. instead of running the script, the Finder will come to the front with the
  71. script selected.
  72.  
  73.  
  74. System Requirements:
  75. OSA Menu requires System 7 and an OSA compliant scripting language
  76. (AppleScript, Userland Frontier, QuicKeys 3, tclScript, etc.). OSA Menu
  77. is 32-bit clean, ‘040 cache, PowerMac, AV and virtual memory compatible. It other
  78. words, as long as you have System 7 and a scripting language it will work!
  79.  
  80.  
  81. Caveats:
  82. * If you move the Scripts folder after the Mac starts up, the folder will
  83. not able to be found by the OSA Menu and you're scripts won't work. So,
  84. don't move it!
  85.  
  86.  
  87. Troubleshooting:
  88. I hope that you won't have any problems with OSA Menu, but if you do, you
  89. can contact me using any of the following means:
  90. Leonard Rosenthol
  91. AppleLink: MACgician
  92. America Online: MACgician
  93. Internet: leonardr@netcom.com
  94.  
  95. *** DO NOT CONTACT ALADDIN SYSTEMS ABOUT THIS PRODUCT ***
  96. They have nothing to do with it, other than letting me release to you for
  97. free, so please send all comments, suggestions, complaints, large sums of
  98. money, single jewish women, etc. to me personally!
  99.  
  100.  
  101. Version History:
  102. 1.0  -  First public release (1/21/94)
  103. 1.0.1 - Minor update (5/9/94)
  104.                 Fixed the famous "-108 error" when running a script in the Finder
  105.                 Improved general stability and memory management
  106.                 Script properties are now updated correctly
  107.  
  108.  
  109. Thanks to:
  110. Richard Clark - for writing the original "Scripting Menu" at MacHack '92.
  111. Jens Alfke - for writing the "Scripting Menu" that Apple never shipped, and
  112. for pioneering some techniques.
  113. Don Olson - for helping out with OSA questions & being an all around dude &
  114. 1/2!
  115. Chris Borton - for hassling me to get a "real" icon!
  116. Jon Pugh - for harrassing me about problems & suggesting how to fix them!
  117. Aladdin Systems - for letting me work on this and release it to the world!
  118. Apple Computer - for NOT shipping their "Scripting Menu", so that I could
  119. do mine
  120. The AppleScript Team, Dave Winer, Doug Baron, Don Brown, and Tim Endres-
  121. for their respective OSA compliant environments w/o which this program
  122. wouldn't make any sense!
  123. All my beta testers - for reporting bugs that I had to fix so you wouldn't
  124. find them!
  125.  
  126.  
  127. Legal Stuff:
  128. Although copyrighted, this software is being licensed to you for your use
  129. free of charge. However, ownership of and interest in this software shall
  130. remain with the author. Use and distribution of this software is governed
  131. by the following terms in an effort to reasonably ensure that this software
  132. will remain freely available and that no one other than the author will
  133. derive a commercial benefit from distributing this software.
  134.  
  135. LICENSE AGREEMENT
  136. “You,” “your,” and the “user” refers to any person or entity which acquires
  137. or uses this software.
  138.  
  139. “Software” refers to any computer programs identified at the start of this
  140. documentation file, together with all codes, techniques, software tools,
  141. formats, designs, concepts, methods, ideas, and documentation associated
  142. with the computer program(s). The term also includes all copies of any
  143. part of the software and documentation.
  144.  
  145. “Author” refers to the author of this software, Leonard Rosenthol.
  146.  
  147. This software is owned by the author and contains valuable and proprietary
  148. information of the author. If you violate any part of this agreement, your
  149. right to use this software terminates automatically. In the event of
  150. termination of this agreement, you must destroy all copies of this software
  151. and derivatives of this software in your possession and cease distributing
  152. the same.
  153.  
  154. This software is being licensed to you as provided by the terms of this
  155. agreement.
  156.  
  157. You may:
  158. 1. Use this software on as many computers as you want at any given time.
  159. 2. Make as many backup copies of this software as you want.
  160. 3. Alter the software in any manner you see fit FOR YOUR OWN PERSONAL USE. 
  161. Such altered versions should not be distributed. The creation of such
  162. derivatives shall not diminish the author's title to this software.
  163. 4. Terminate this agreement at any time by destroying all copies of this
  164. software and derivatives of this software and cease distributing the same.
  165.  
  166. You may not:
  167. 1. Create any derivative works from this software for distribution.
  168. 2. Reverse engineer, disassemble, decompile, or otherwise attempt to
  169. discover the logic or source code to this software.
  170.  
  171. OSA Menu may be distributed for non-commercial purposes. 
  172.  
  173. It may also be freely distributed via wire or electronic communications
  174. (BBS's and online information systems) for the sole purpose of use by their
  175. customers.
  176.  
  177. Contact Leonard Rosenthol at the addresses within this document if you wish
  178. to distribute this software in a compilation or for commercial usage, or if
  179. you have any questions about its redistribution. 
  180.  
  181. Disclaimer of warranty:
  182. In using this software, you understand and agree that this software is
  183. provided “as is” without warranty of any kind. The entire risk as to the
  184. results and performance of using this software lies entirely with you, the
  185. user. The author does not make any warranties, either expressed or
  186. implied, including but not limited to implied warranties of merchantability
  187. and fitness for a particular purpose, with respect to this software.
  188.  
  189. In no event shall the author be liable for any consequential, incidental,
  190. or special damages whatsoever (including without limitation damages for
  191. loss of critical data, loss of profits, interruption of business, and the
  192. like) arising out of the use or inability to use this software. Because
  193. some states do not allow the exclusion or limitation of liability for
  194. consequential or incidental damages, the above limitations may not apply to
  195. you.
  196.  
  197. Although the author would appreciate any feedback and bug reports, the
  198. author shall not be responsible for correcting any problems which you
  199. discover or otherwise help you maintain and use this software. 
  200. Furthermore, the author may at any time replace, modify, alter, improve,
  201. enhance or change this software.
  202.  
  203. Complete agreement:
  204. This agreement constitutes the entire agreement and supersedes any prior
  205. agreements between you and the author concerning this software. This
  206. agreement cannot be amended, modified, or waived except in writing.
  207.  
  208. General:
  209. If any provision of this agreement shall be found to be unenforceable, it
  210. shall be deemed severed from the remainder of this agreement.
  211.  
  212. This agreement shall be construed in accordance with the laws of the State
  213. of California. Any arbitration or litigation relating to this agreement
  214. shall take place in the State of California. The parties further submit to
  215. waive any objections to personal jurisdiction of and venue in any of the
  216. following forums: U.S. District Court for the Northern District of
  217. California, California Superior Court for Santa Cruz County, Santa Cruz
  218. County Municipal Court or any other forum in Santa Cruz County, for any
  219. litigation arising out of this agreement.
  220.  
  221. U.S. GOVERNMENT RESTRICTED RIGHTS
  222. This Software is provided with RESTRICTED RIGHTS. Use, duplication, or
  223. disclosure by the government is subject to restrictions set forth in
  224. subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer
  225. Software clause at 48 CFR 252.227-7013, or in subparagraphs (a) through (d)
  226. of the Commercial Computer Software Restricted Rights clause at 48 CFR
  227. 52.227-19, as applicable. The contractor/manufacturer is Leonard
  228. Rosenthol.
  229.  
  230.  
  231. All trademarks are held by their respective owners.
  232.